home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / fscmd.man < prev    next >
Encoding:
Text File  |  1992-09-28  |  8.1 KB  |  267 lines
  1.  
  2.  
  3.  
  4. FSCMD                     User Commands                     FSCMD
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      fscmd - Set various parameters in the filesystem
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ffssccmmdd -[mmMM] _s_i_z_e
  15.      ffssccmmdd -[ffssllLLNNCCvv]
  16.      ffssccmmdd -[wwWWxxXXyyzz]
  17.      ffssccmmdd -[BBOOttDDRR]
  18.      ffssccmmdd -ggeenneerriicc _a_r_g
  19.  
  20. _________________________________________________________________
  21.  
  22. IINNTTRROODDUUCCTTIIOONN
  23.      This command is used to set various  kernel  variables  that
  24.      control  the filesystem cache, tracing and debugging output,
  25.      and other features of the system.  It is  implemented  using
  26.      the Fs_Command system call.
  27.  
  28. CCAACCHHEE SSIIZZEE
  29.      The minimum and  maximum  number  of  filesystem  blocks  (4
  30.      Kbytes  each)  in  the  main memory cache is set with the -m
  31.      (minimum) and -M  (maximum)  arguments.   Follow  either  of
  32.      these with the number of 4-Kbyte blocks, ie.  -M 512 means a
  33.      max of 2 Megabytes in the cache.
  34.  
  35. CCAACCHHEE CCOONNTTRROOLL
  36.      --ff   The entire contents of the cache gets written-back  and
  37.           then invalidated by specifying --ff.
  38.  
  39.      --ss [00|11]
  40.           The background process that writes back dirty data from
  41.           the  cache  can  be disabled by specifying the ``--ss 00''
  42.           flag.  This should be  done  when  patching  a  mounted
  43.           filesystem  or  else  bad  internal structures will get
  44.           pushed to disk.  Enable the sync daemon with ``--ss 11''.
  45.  
  46.      --ll [00|11]
  47.           Biasing against ``large'' files in the cache is enabled
  48.           with ``--ll 11'' and turned off with ``--ll 00''.
  49.  
  50.      --LL _s_i_z_e
  51.           This sets what portion of the maximum cache size a file
  52.           must  occupy before it is considered a large file.  For
  53.           example a value of 8 would indicate that if a  file  is
  54.           larger  than  1/8  of the maximum cache size then it is
  55.           considered a large file.
  56.  
  57.      --CC [00|11]
  58.           Caching on diskless nodes can  be  disabled  with  ``--CC
  59.           00'',  and turned back on with ``--CC 11''.  This has to be
  60.           done on a file server to affect its clients; use of the
  61.           -C flag on clients will have no effect.
  62.  
  63.  
  64.  
  65. Sprite v.1.0      Printed:  September 28, 1992                  1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. FSCMD                     User Commands                     FSCMD
  73.  
  74.  
  75.  
  76.      --NN [00|11]
  77.           The name cache on a diskfull node is disabled with ``--NN
  78.           00'' and enabled with ``--NN 11''.
  79.  
  80.      --vv [00|11]
  81.           The Virtual Memory cache of recently used program  seg-
  82.           ments  is  disabled with ``--vv 11'' (yes, 1), and enabled
  83.           with ``--vv 00''.
  84.  
  85.      --bb _N Set the maximum  number  of  block  cleaner  processes.
  86.           This controls the amount of overlap during cache write-
  87.           backs.  3 processes provides the most bandwidth, but it
  88.           does load the server.
  89.  
  90.      --rr _N Set the read ahead distance (in  4K  blocks).   When  a
  91.           read  on  the  cache  is  done,  the transfer of N more
  92.           blocks is initiated.
  93.  
  94. CCAACCHHEE WWRRIITTEE BBAACCKK PPOOLLIICCYY
  95.      Normally, dirty blocks in the file system cache are aged for
  96.      at  least  30 seconds before being written back.  This gives
  97.      the best performance, although alternate strategies  can  be
  98.      tried  out  with  the following flags.  There are two write-
  99.      back policies involved: the client's and the server's.  Each
  100.      of  the flags below only affects the policy on the client or
  101.      server on which it is invoked.  For example the client could
  102.      be  using a write-through policy and the server a 30-second-
  103.      delay policy.  This would mean that client writes would  not
  104.      complete  until the blocks have been written across the net-
  105.      work into the server's cache, but the blocks  would  not  be
  106.      written back to disk until at least 30 seconds later.
  107.  
  108.      --SS _s_e_c_o_n_d_s
  109.           Set the cache write-back interval in seconds.
  110.  
  111.      --ww [00|11]
  112.           Write-through caching is enabled with ``--ww 11'' and dis-
  113.           abled  with  ``--ww  00''.   With write-through, the write
  114.           system call does not complete until the cache block  is
  115.           written back.
  116.  
  117.      --WW [[00|11]
  118.           Write-back-on-close caching is enabled  with  ``--WW  11''
  119.           and  disabled  with ``--WW 00''.  With write-back-on-close
  120.           the close system call does not complete  until  all  of
  121.           the file's dirty blocks are written back.
  122.  
  123.      --xx [00|11]
  124.           Write-back of temporary files can be set  to  delay  as
  125.           long  as  possible  with  ``--xx 11''.  This is turned off
  126.           with ``--xx 00''.  Normally temporary files are files that
  127.           are in the /tmp directory.
  128.  
  129.  
  130.  
  131. Sprite v.1.0      Printed:  September 28, 1992                  2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. FSCMD                     User Commands                     FSCMD
  139.  
  140.  
  141.  
  142.      --XX _d_i_r_N_u_m_b_e_r
  143.           This identifies the temporary  directory  to  the  file
  144.           system.   _d_i_r_N_u_m_b_e_r should be the inode number of /tmp.
  145.           Unfortunately, only one temporary directory  is  under-
  146.           stood.
  147.  
  148.      --yy [00|11]
  149.           Write-back-as-soon-as-possible caching is enabled  with
  150.           ``--yy  11''  and  turned  off with ``--yy 00''.  With write-
  151.           back-ASAP, the write system call completes  immediately
  152.           and  the cache block is scheduled to be written out as-
  153.           soon-as-possible.
  154.  
  155.      --zz [00|11]
  156.           Write-back-on-last-dirty-block caching is enabled  with
  157.           ``--zz  11''  and  turned  off with ``--zz 00''.  This policy
  158.           only works on a server.  It  means  the  server  writes
  159.           back its blocks for a file after getting the last dirty
  160.           block for the file from a client.   For  example,  this
  161.           policy  combined with a write-back-on-close client pol-
  162.           icy would mean that after a client closes a  file,  all
  163.           of  the  files  blocks  are  guaranteed  to  be  on the
  164.           server's disk.
  165.  
  166. DDIISSKK LLAAYYOOUUTT
  167.      --BB _s_k_e_w
  168.           Set the block skew for disk allocation.  Not  supported
  169.           in kernel yet.
  170.  
  171. TTRRAACCIINNGG//DDEEBBUUGG FFLLAAGGSS
  172.      There are several  tracing/debugging  flags  that  can  have
  173.      their  value  set  via ffssccmmdd.  Each flag expects a following
  174.      integer on the command line that will specify the new  value
  175.      of  the  flag or trace level variable.  FFssccmmdd prints out the
  176.      old value of the flag as it changes it.  Some of  the  flags
  177.      are  Booleans  that are set with values of 1 for TRUE, and 0
  178.      for FALSE.
  179.  
  180.      --OO   The fsStats structure is zeroed out.  This  information
  181.           is displayed with the fsStat program.
  182.  
  183.      --tt [00|11]
  184.           Filesystem tracing is  enabled  with  ``--tt  11''.   This
  185.           dumps  internal  events  into  a circular trace record.
  186.           The trace  gets  printed  via  a  special  console  key
  187.           sequence, ``LL11--ff''.
  188.  
  189.      --DD [00|11]
  190.           Cache consistency debug print statements are turned  on
  191.           with ``--DD 11'', and turned off with ``--DD 00''.
  192.  
  193.      --RR [00|11]
  194.  
  195.  
  196.  
  197. Sprite v.1.0      Printed:  September 28, 1992                  3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. FSCMD                     User Commands                     FSCMD
  205.  
  206.  
  207.  
  208.           Read ahead tracing is enabled with ``--RR 11'' and  turned
  209.           off with ``--RR 00''.
  210.  
  211.      --ggeenneerriicc _a_r_g
  212.           A generic hook for temporary  file  system  operations.
  213.           The result depends on arg.
  214.  
  215. SSEEEE AALLSSOO
  216.      fsStat, prefix, rpcCmd
  217.  
  218. FFIILLEESS
  219.      /local/diskcmds          - Server local startup file
  220.      /bootcmds      - Network wide startup file
  221.  
  222. KKEEYYWWOORRDDSS
  223.      debugging, trace, cache, write-back
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. Sprite v.1.0      Printed:  September 28, 1992                  4
  264.  
  265.  
  266.  
  267.